Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 1 - Appearance Manager Reference / Appearance Manager Functions

Drawing Appearance-Compliant Menus /

GetThemeMenuTitleExtra

NEW WITH THE APPEARANCE MANAGER

Gets a measurement of the space (in pixels) surrounding a menu title in a given theme.

pascal OSStatus GetThemeMenuTitleExtra (
                     SInt16 *outWidth,
                     Boolean inIsSquished);

outWidth

On output, the distance (in pixels) between the width of the menu title and its frame.

inIsSquished

A Boolean value. If all the titles do not fit in the menu bar and you wish to condense the menu title's spacing to fit, set to true; if set to false, the menu title will not be condensed.

function result

A result code; see "Result Codes".

DISCUSSION

The GetThemeMenuTitleExtra function should be called when you are writing your own menu definition function and wish to be Appearance-compliant. Once you have determined the height and width of the content of a menu title, call GetThemeMenuTitleExtra to get the distance (in pixels) surrounding the menu title in the current theme. This includes space on either side of the menu title.

SPECIAL CONSIDERATIONS

Make sure Appearance Manager 1.0.1 is present before calling the GetThemeMenuTitleExtra function. See "Appearance Manager Gestalt Selector Constants" for details on how to determine if the Appearance Manager is present and what its version is, if so.